home *** CD-ROM | disk | FTP | other *** search
-
-
-
- ddddmmmmIIIICCCC((((3333ddddmmmm)))) ddddmmmmIIIICCCC((((3333ddddmmmm))))
-
-
-
- NNNNAAAAMMMMEEEE
- ddddmmmmIIIICCCCSSSSeeeennnndddd,,,, - transfer input to the image converter context
-
- SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
- ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ddddmmmm____iiiimmmmaaaaggggeeeeccccoooonnnnvvvveeeerrrrtttt....hhhh>>>>
-
- DDDDMMMMssssttttaaaattttuuuussss ddddmmmmIIIICCCCSSSSeeeennnndddd((((DDDDMMMMiiiimmmmaaaaggggeeeeccccoooonnnnvvvveeeerrrrtttteeeerrrr ccccoooonnnnvvvveeeerrrrtttteeeerrrr,,,, DDDDMMMMbbbbuuuuffffffffeeeerrrr ssssrrrrccccBBBBuuuuffffffffeeeerrrr,,,,
- iiiinnnntttt nnnnuuuummmmRRRReeeeffffBBBBuuuuffffffffeeeerrrrssss,,,, DDDDMMMMbbbbuuuuffffffffeeeerrrr ****rrrreeeeffffBBBBuuuuffffffffeeeerrrrssss))));;;;
-
- PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
- This function sends a source buffer together with its reference buffers
- to the image converter.
-
- _c_o_n_v_e_r_t_e_r the converter instance
-
- _s_r_c_B_u_f_f_e_r the source buffer
-
- _n_u_m_R_e_f_B_u_f_f_e_r_s
- the number of reference buffers pointed to by _r_e_f_B_u_f_f_e_r_s
-
- _r_e_f_B_u_f_f_e_r_s an array of reference buffers
-
- DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
- The converter will perform the conversion on the srcBuffer, based on the
- conversion context. Prior to calling ddddmmmmIIIICCCCSSSSeeeennnndddd, ddddmmmmIIIICCCCSSSSeeeettttSSSSrrrrccccPPPPaaaarrrraaaammmmssss and
- ddddmmmmIIIICCCCSSSSeeeettttDDDDssssttttPPPPaaaarrrraaaammmmssss should be called to provide the necessary parameters
- needed to set up the conversion context accordingly.
-
- The buffer, _s_r_c_B_u_f_f_e_r, must be allocated by the caller (see
- ddddmmmmBBBBuuuuffffffffeeeerrrrAAAAllllllllooooccccaaaatttteeee((((3333ddddmmmm))))). When the buffer is sent to the converter, the
- converter will do the necessary attachment to the buffer. The buffer can
- be freed (see ddddmmmmBBBBuuuuffffffffeeeerrrrFFFFrrrreeeeeeee((((3333ddddmmmm))))) after ddddmmmmIIIICCCCSSSSeeeennnndddd returns, if it is no
- longer referenced or needed.
-
- The contents of _s_r_c_B_u_f_f_e_r should not be modified after calling ddddmmmmIIIICCCCSSSSeeeennnndddd.
-
- ddddmmmmIIIICCCCSSSSeeeennnndddd is an asynchronous operation. When ddddmmmmIIIICCCCSSSSeeeennnndddd returns, conversion
- may or may not have been performed. ddddmmmmIIIICCCCGGGGeeeettttDDDDssssttttFFFFiiiilllllllleeeedddd can be used to
- determine if any output is available.
-
- Two types of error can occur in ddddmmmmIIIICCCCSSSSeeeennnndddd. Either the input queue is full
- or any of the parameters passed to the function is invalid. In software
- codecs the queues grow until you run out of memory. However in case of
- hardware codecs it is not so. In these cases, DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE is returned and
- an error is set (errors can be retrieved using dmGetError(3dm)).
-
- If an error occurs during the conversion after ddddmmmmIIIICCCCSSSSeeeennnndddd has returned, an
- error will be returned in a subsequent ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee call. For example, if
- invalid bytes are passed to an image converter, ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee on the
- corresponding expected output buffer will return DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE (see
- ddddmmmmIIIICCCCRRRReeeecccceeeeiiiivvvveeee((((3333ddddmmmm))))).
-
-
-
-
- PPPPaaaaggggeeee 1111
-
-
-
-
-
-
- ddddmmmmIIIICCCC((((3333ddddmmmm)))) ddddmmmmIIIICCCC((((3333ddddmmmm))))
-
-
-
- NNNNOOOOTTTTEEEESSSS
- In the current release, numRefBuffers and refBuffers are ignored.
-
- SSSSEEEEEEEE AAAALLLLSSSSOOOO
- dmBufferAllocate(3dm), dmICSetSrcParams(3dm), dmICSetDstParams(3dm),
- dmICSetConvParams(3dm), dmICReceive(3dm), dmICWork(3dm).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- PPPPaaaaggggeeee 2222
-
-
-
-